home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / os2 / he2101.arj / README.TXT < prev    next >
Text File  |  1994-06-06  |  8KB  |  235 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                H E X E D I T / 2
  11.  
  12.                                =================
  13.  
  14.                                   Version 1.01
  15.  
  16.  
  17.  
  18.                 An OS/2 Presentation Manager binary file editor.
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                 Copyright (c) 1994 Bennett C. Baker and B::Ware.
  25.  
  26.                               All rights reserved.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                     B::Ware
  43.                                   7 Rosen Road
  44.                                Dedham, MA  02026
  45.                                   617-326-4719
  46.                                  CIS 70274,3147
  47.  
  48.  
  49.      INTRODUCTION
  50.  
  51.      Thank you for evaluating HexEdit/2, a shareware OS/2 Presentation
  52.      Manager binary file editor from B::Ware.  With HexEdit/2, you can view
  53.      and edit files in single or multibyte octal, decimal, or hexadecimal
  54.      binary representation.  You can resize an existing file or allocate a
  55.      new file from scratch, and perform search and replace functions
  56.      forward or backward through the file.  HexEdit/2 provides a full help
  57.      system as well as on-line documentation in the VIEW-compatible (.INF)
  58.      format.
  59.  
  60.      LICENSE AGREEMENT
  61.  
  62.      HexEdit/2 is shareware.  You are free to use the program for a period
  63.      of 21 days for the purpose of evaluation.  If you decide to continue
  64.      using the program after the 21 day evaluation period, you must
  65.      register it.  To register, send $15 (US funds, please) to:
  66.  
  67.           B::Ware
  68.           7 Rosen Road
  69.           Dedham, MA  02026
  70.           USA
  71.  
  72.      You may make copies of this program and distribute them freely, as
  73.      long as you include all of the files that you originally received with
  74.      your shareware copy.  When you give a shareware copy of this program
  75.      to another person, you agree to inform them that their copy is to be
  76.      used for a time limited evaluation period, and that they must register
  77.      their copy if they continue to use the program after the end of the
  78.      evaluation period.  You may not sell or distribute this program for a
  79.      fee in excess of media costs and/or shipping charges actually incurred
  80.      in copying and distributing this program.
  81.  
  82.      DISCLAIMER
  83.  
  84.      IF USED IMPROPERLY, THIS PROGRAM IS CAPABLE OF DESTROYING ALL DATA ON
  85.      YOUR COMPUTER SYSTEM.  THIS PROGRAM IS PROVIDED "AS-IS", WITH NO
  86.      WARRANTY OF MERCHANTABILITY OR FITNESS OF PURPOSE.   IN NO EVENT SHALL
  87.      B::WARE OR BENNETT C. BAKER BE LIABLE FOR ANY DAMAGES WHATSOEVER
  88.      ARISING OUT OF USE OF THIS PROGRAM.
  89.  
  90.      INSTALLATION
  91.  
  92.      There are 7 files comprising the HexEdit/2 installation:
  93.  
  94.           HEXEDIT2.EXE   - the executable
  95.           HEXEDIT2.HLP   - the on-line help file
  96.           HEXEDIT2.INF   - the VIEWable primary documentation file
  97.           README.TXT     - the README file (this file)
  98.           REGISTER.TXT   - the (optional!) registration form
  99.           HISTORY.TXT    - the program's revision history
  100.           FILE_ID.DIZ    - information for BBS systems
  101.  
  102.      These files can go just about anywhere, with the caveat that the
  103.      HEXEDIT2.HLP file should be in either the HEXEDIT2.EXE directory or
  104.      one of the directories listed in the HELP environment variable.
  105.  
  106.  
  107.  
  108.      ----------------------------------------------------------------------
  109.      HexEdit/2 ver. 1.01           README.TXT                        Page 1
  110.  
  111.  
  112.      An eighth file, INICLEAR.EXE, is intended for one-time use in cleaning
  113.      HexEdit/2 information out of the OS2.INI profile file.
  114.  
  115.      USING INICLEAR.EXE
  116.  
  117.      The INICLEAR.EXE utility is provided for those users who are upgrading
  118.      from HexEdit/2 version 1.00.  Version 1.00 used the OS2.INI file to
  119.      save window position and font information; version 1.01 and future
  120.      versions use a private INI file (HEXEDIT2.INI, located in the same
  121.      directory as HEXEDIT2.EXE), for that purpose.  Users who wish to
  122.      remove the HexEdit/2 information from OS2.INI need simply run INICLEAR
  123.      from either the WPS or an OS/2 Command Interpreter (CMD or 4OS2)
  124.      session.
  125.  
  126.      GETTING STARTED
  127.  
  128.      The primary documentation file is HEXEDIT2.INF, readable with the OS/2
  129.      VIEW command.
  130.  
  131.      HexEdit/2 can be opened from either the command line or as a WPS
  132.      Program Object.  From the command line, it will accept a single
  133.      argument indicating the file to display for edit (additional command
  134.      line entries are ignored).  As a WPS Program Object, you can open it
  135.      either by double-clicking on the Program Object icon or by dragging a
  136.      Data File Object onto the icon (rudimentary drag-n-drop).
  137.  
  138.      If you don't want to edit an existing file, you can use the File
  139.      Allocate and File Resize menus to create a new buffer, which can then
  140.      be saved with the File Save As command.
  141.  
  142.      Buffer display has 3 fields: Line Numbers, Binary Data, and ASCII
  143.      data.  You can change the format of the Line Number field to octal,
  144.      decimal, or hexadecimal.  You can use those same formats for the
  145.      Binary Data field, and you can also specify how many bytes (1, 2, or
  146.      4) are contained in each entity of that field.  Multi-byte displays
  147.      use little-endian format (like Intel and VAX processors).
  148.  
  149.      A buffer is normally displayed in Read-Only mode, meaning that you
  150.      cannot edit it.  To edit a buffer, select Options/ReadOnly to toggle
  151.      the Read-Only mode flag.
  152.  
  153.      You can edit a file in either its Binary or ASCII fields.  In the
  154.      Binary field, you use the 0-9 and A-F characters appropriate to the
  155.      selected display mode (for instance, you can't use the hexadecimal A-F
  156.      characters if the display mode is octal or decimal).  In the ASCII
  157.      field, any typeable character is an editing character.
  158.  
  159.      You can switch between Binary and ASCII fields with the TAB key, or by
  160.      positioning the mouse cursor on any character and clicking button 1.
  161.  
  162.      You can perform Search or Search and Replace operations on data within
  163.      the buffer.  Both Search and Replace strings can be ASCII strings or
  164.      sequences of octal, decimal, or hex digits.
  165.  
  166.      You can also go to a specific offset (specified in octal, decimal, or
  167.      hex) within the editing buffer.
  168.  
  169.  
  170.  
  171.      ----------------------------------------------------------------------
  172.      HexEdit/2 ver. 1.01           README.TXT                        Page 2
  173.  
  174.  
  175.      HexEdit/2 allows you to use any of the fixed-pitch fonts available on
  176.      your OS/2 system, and will save your font selection for subsequent
  177.      use.
  178.  
  179.      SUPPORT
  180.  
  181.      Support for HexEdit/2 will be provided on CompuServe in the OS2SHARE
  182.      forum (section 1 of the OS2BVEN forum).  Address messages to Bennett
  183.      C. Baker, 70274,3147.
  184.  
  185.      Internet users can send E-mail to 70274.3147@compuserve.com.
  186.  
  187.      ACKNOWLEDGMENTS
  188.  
  189.      Thanks to:
  190.  
  191.      Larry Waibel, who first got me interested in writing a PM binary
  192.      editor.
  193.  
  194.      Dave Levitt, who published an extensive feature set wish list (I'm
  195.      getting there...).
  196.  
  197.      Guy Scharf, who answered my questions about becoming a vendor on
  198.      OS2SHARE.
  199.  
  200.      Special thanks to Rhonda, who put up with me while I was wrestling
  201.      with the innards of P.M. and the voluminous IBM documentation.
  202.  
  203.      ABOUT B::WARE
  204.  
  205.      B::Ware is a consulting firm with over 14 years experience in MS-DOS
  206.      and OS/2 applications and system development, Novell NetWare NLM and
  207.      driver development, real-time embedded systems hardware and software
  208.      development, and general telecomm and ISDN protocols and
  209.      implementations.  If you think we can help you solve a problem, please
  210.      contact us at:
  211.  
  212.           B::Ware
  213.           7 Rosen Road
  214.           Dedham, MA  02026
  215.           (617)-326-4719
  216.           CIS 70274,3147
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.      ----------------------------------------------------------------------
  235.      HexEdit/2 ver. 1.01           README.TXT                        Page 3